<!DOCTYPE html><html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en" data-whc_version="25.0">
    <head><link rel="shortcut icon" href="../../../oxygen-webhelp/template/images/favicon.png"/><link rel="icon" href="../../../oxygen-webhelp/template/images/favicon.png"/><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"/><meta name="viewport" content="width=device-width, initial-scale=1.0"/><meta http-equiv="X-UA-Compatible" content="IE=edge"/><meta name="copyright" content="(C) Copyright 2024"/><meta name="generator" content="DITA-OT"/><meta name="description" content="You must register a Data Collector to work with StreamSets Control Hub . When you register a Data Collector , Data Collector generates an authentication token that it uses to issue authenticated ..."/><meta name="prodname" content="Data Collector"/><meta name="version" content="3"/><meta name="release" content="16"/><meta name="modification" content="0"/>        
      <title>Register Data Collector with Control Hub</title><!--  Generated with Oxygen version 25.1, build number 2023042410.  --><meta name="wh-path2root" content="../../../"/><meta name="wh-toc-id" content="concept_kc4_xyf_xw-d16893e61612"/><meta name="wh-source-relpath" content="datacollector/UserGuide/DPM/RegisterSDCwithDPM.dita"/><meta name="wh-out-relpath" content="datacollector/UserGuide/DPM/RegisterSDCwithDPM.html"/>

    <link rel="stylesheet" type="text/css" href="../../../oxygen-webhelp/app/commons.css?buildId=2023042410"/>
    <link rel="stylesheet" type="text/css" href="../../../oxygen-webhelp/app/topic.css?buildId=2023042410"/>

    <script src="../../../oxygen-webhelp/app/options/properties.js?buildId=20240802104629"></script>
    <script src="../../../oxygen-webhelp/app/localization/strings.js?buildId=2023042410"></script>
    <script src="../../../oxygen-webhelp/app/search/index/keywords.js?buildId=20240802104629"></script>
    <script defer="defer" src="../../../oxygen-webhelp/app/commons.js?buildId=2023042410"></script>
    <script defer="defer" src="../../../oxygen-webhelp/app/topic.js?buildId=2023042410"></script>
<link rel="stylesheet" type="text/css" href="../../../oxygen-webhelp/template/light.css?buildId=2023042410"/><link rel="stylesheet" type="text/css" href="../../../skin.css"/></head>

    <body class="wh_topic_page frmBody">
        
        
        

        
<nav class="navbar navbar-default wh_header" data-whc_version="25.0">
    <div class="container-fluid">
        <div class="wh_header_flex_container navbar-nav navbar-expand-md navbar-dark">
            <div class="wh_logo_and_publication_title_container">
                <div class="wh_logo_and_publication_title">
                    
                    <!--
                            This component will be generated when the next parameters are specified in the transformation scenario:
                            'webhelp.logo.image' and 'webhelp.logo.image.target.url'.
                            See: http://oxygenxml.com/doc/versions/17.1/ug-editor/#topics/dita_webhelp_output.html.
                    -->
                    
                    <div class=" wh_publication_title "><a href="../../../index.html"><span class="booktitle">  <span class="ph mainbooktitle"><span class="ph">Data Collector</span> User Guide</span>  </span></a></div>
                    
                </div>
                
                <!-- The menu button for mobile devices is copied in the output only when the 'webhelp.show.top.menu' parameter is set to 'yes' -->
                
            </div>

            <div class="wh_top_menu_and_indexterms_link collapse navbar-collapse">
                
                
                <div class=" wh_indexterms_link "><a href="../../../indexTerms.html" title="Index" aria-label="Go to index terms page"><span>Index</span></a></div>
                
            </div>
        </div>
    </div>
</nav>

        <div class=" wh_search_input navbar-form wh_topic_page_search search " role="form">


<form id="searchForm" method="get" role="search" action="../../../search.html"><div><input type="search" placeholder="Search " class="wh_search_textfield" id="textToSearch" name="searchQuery" aria-label="Search query" required="required"/><button type="submit" class="wh_search_button" aria-label="Search"><span class="search_input_text">Search</span></button></div></form>

</div>
        
        <div class="container-fluid">
            <div class="row">

                <nav class="wh_tools d-print-none">
                    
<div data-tooltip-position="bottom" class=" wh_breadcrumb "><ol class="d-print-none"><li><span class="home"><a href="../../../index.html"><span>Home</span></a></span></li><li><div class="topicref" data-id="concept_ugp_kwf_xw"><div class="title"><a href="../../../datacollector/UserGuide/DPM/DPM_title.html">StreamSets Control Hub</a></div></div></li><li class="active"><div class="topicref" data-id="concept_kc4_xyf_xw"><div class="title"><a href="../../../datacollector/UserGuide/DPM/RegisterSDCwithDPM.html#concept_kc4_xyf_xw">Register Data Collector with <span class="ph">Control Hub</span></a><div class="wh-tooltip"><p class="shortdesc"></p></div></div></div></li></ol></div>



                    <div class="wh_right_tools "><button class="wh_hide_highlight" aria-label="Toggle search highlights" title="Toggle search highlights"></button><button class="webhelp_expand_collapse_sections" data-next-state="collapsed" aria-label="Collapse sections" title="Collapse sections"></button><div class=" wh_navigation_links "><span id="topic_navigation_links" class="navheader">
  
<span class="navprev"><a class="- topic/link link" href="../../../datacollector/UserGuide/DPM/OrgUserAccount.html#concept_lry_34g_xw" title="Request a Control Hub Organization and User Account" aria-label="Previous topic: Request a Control Hub Organization and User Account" rel="prev"></a></span>  
<span class="navnext"><a class="- topic/link link" href="../../../datacollector/UserGuide/DPM/AggregatedStatistics.html#concept_h2q_mb5_xw" title="Pipeline Statistics" aria-label="Next topic: Pipeline Statistics" rel="next"></a></span>  </span></div>
<!--External resource link-->
<div class=" wh_print_link print d-none d-md-inline-block "><button onClick="window.print()" title="Print this page" aria-label="Print this page"></button></div>
                        
                        
                        
                        
                    </div>
                </nav>
            </div>

            

<div class="wh_content_area">
                <div class="row">
                    


                        <nav role="navigation" id="wh_publication_toc" class="col-lg-3 col-md-3 col-sm-12 d-md-block d-none d-print-none">
<div id="wh_publication_toc_content">


                            <div class=" wh_publication_toc " data-tooltip-position="right"><span class="expand-button-action-labels"><span id="button-expand-action" role="button" aria-label="Expand"></span><span id="button-collapse-action" role="button" aria-label="Collapse"></span><span id="button-pending-action" role="button" aria-label="Pending"></span></span><ul role="tree" aria-label="Table of Contents"><li role="treeitem" aria-expanded="false"><div data-tocid="concept_htw_ghg_jq-d16893e53" class="topicref" data-id="concept_htw_ghg_jq" data-state="not-ready"><span role="button" tabindex="0" aria-labelledby="button-expand-action concept_htw_ghg_jq-d16893e53-link" class="wh-expand-btn"></span><div class="title"><a href="../../../datacollector/UserGuide/Getting_Started/GettingStarted_Title.html#concept_htw_ghg_jq" id="concept_htw_ghg_jq-d16893e53-link">Getting Started</a></div></div></li><li role="treeitem" aria-expanded="false"><div data-tocid="concept_l2v_nlp_mpb-d16893e331" class="topicref" data-id="concept_l2v_nlp_mpb" data-state="not-ready"><span role="button" tabindex="0" aria-labelledby="button-expand-action concept_l2v_nlp_mpb-d16893e331-link" class="wh-expand-btn"></span><div class="title"><a href="../../../datacollector/UserGuide/ReleaseNotes/ReleaseNotes.html#concept_l2v_nlp_mpb" id="concept_l2v_nlp_mpb-d16893e331-link">Release Notes</a></div></div></li><li role="treeitem" aria-expanded="false"><div data-tocid="concept_l4q_flb_kr-d16893e2582" class="topicref" data-id="concept_l4q_flb_kr" data-state="not-ready"><span role="button" tabindex="0" aria-labelledby="button-expand-action concept_l4q_flb_kr-d16893e2582-link" class="wh-expand-btn"></span><div class="title"><a href="../../../datacollector/UserGuide/Installation/Install_title.html" id="concept_l4q_flb_kr-d16893e2582-link">Installation</a></div></div></li><li role="treeitem" aria-expanded="false"><div data-tocid="concept_ylh_yyz_ky-d16893e3984" class="topicref" data-id="concept_ylh_yyz_ky" data-state="not-ready"><span role="button" tabindex="0" aria-labelledby="button-expand-action concept_ylh_yyz_ky-d16893e3984-link" class="wh-expand-btn"></span><div class="title"><a href="../../../datacollector/UserGuide/Configuration/Config_title.html" id="concept_ylh_yyz_ky-d16893e3984-link">Configuration</a></div></div></li><li role="treeitem" aria-expanded="false"><div data-tocid="concept_ejk_f1f_5v-d16893e7058" class="topicref" data-id="concept_ejk_f1f_5v" data-state="not-ready"><span role="button" tabindex="0" aria-labelledby="button-expand-action concept_ejk_f1f_5v-d16893e7058-link" class="wh-expand-btn"></span><div class="title"><a href="../../../datacollector/UserGuide/Upgrade/Upgrade_title.html" id="concept_ejk_f1f_5v-d16893e7058-link">Upgrade</a></div></div></li><li role="treeitem" aria-expanded="false"><div data-tocid="concept_qsw_cjy_bt-d16893e10103" class="topicref" data-id="concept_qsw_cjy_bt" data-state="not-ready"><span role="button" tabindex="0" aria-labelledby="button-expand-action concept_qsw_cjy_bt-d16893e10103-link" class="wh-expand-btn"></span><div class="title"><a href="../../../datacollector/UserGuide/Pipeline_Design/PipelineDesign_title.html" id="concept_qsw_cjy_bt-d16893e10103-link">Pipeline Concepts and Design</a></div></div></li><li role="treeitem" aria-expanded="false"><div data-tocid="concept_qn1_wn4_kq-d16893e11199" class="topicref" data-id="concept_qn1_wn4_kq" data-state="not-ready"><span role="button" tabindex="0" aria-labelledby="button-expand-action concept_qn1_wn4_kq-d16893e11199-link" class="wh-expand-btn"></span><div class="title"><a href="../../../datacollector/UserGuide/Pipeline_Configuration/PipelineConfiguration_title.html" id="concept_qn1_wn4_kq-d16893e11199-link">Pipeline Configuration</a></div></div></li><li role="treeitem" aria-expanded="false"><div data-tocid="concept_hdr_gyw_41b-d16893e13057" class="topicref" data-id="concept_hdr_gyw_41b" data-state="not-ready"><span role="button" tabindex="0" aria-labelledby="button-expand-action concept_hdr_gyw_41b-d16893e13057-link" class="wh-expand-btn"></span><div class="title"><a href="../../../datacollector/UserGuide/Data_Formats/DataFormats-Title.html" id="concept_hdr_gyw_41b-d16893e13057-link">Data Formats</a><div class="wh-tooltip"><p class="shortdesc"></p></div></div></div></li><li role="treeitem" aria-expanded="false"><div data-tocid="concept_yjl_nc5_jq-d16893e14164" class="topicref" data-id="concept_yjl_nc5_jq" data-state="not-ready"><span role="button" tabindex="0" aria-labelledby="button-expand-action concept_yjl_nc5_jq-d16893e14164-link" class="wh-expand-btn"></span><div class="title"><a href="../../../datacollector/UserGuide/Origins/Origins_title.html" id="concept_yjl_nc5_jq-d16893e14164-link">Origins</a></div></div></li><li role="treeitem" aria-expanded="false"><div data-tocid="concept_yjl_nc5_jq-d16893e35197" class="topicref" data-id="concept_yjl_nc5_jq" data-state="not-ready"><span role="button" tabindex="0" aria-labelledby="button-expand-action concept_yjl_nc5_jq-d16893e35197-link" class="wh-expand-btn"></span><div class="title"><a href="../../../datacollector/UserGuide/Processors/Processors_title.html" id="concept_yjl_nc5_jq-d16893e35197-link">Processors</a></div></div></li><li role="treeitem" aria-expanded="false"><div data-tocid="concept_agj_cfj_br-d16893e44037" class="topicref" data-id="concept_agj_cfj_br" data-state="not-ready"><span role="button" tabindex="0" aria-labelledby="button-expand-action concept_agj_cfj_br-d16893e44037-link" class="wh-expand-btn"></span><div class="title"><a href="../../../datacollector/UserGuide/Destinations/Destinations-title.html" id="concept_agj_cfj_br-d16893e44037-link">Destinations</a></div></div></li><li role="treeitem" aria-expanded="false"><div data-tocid="concept_umc_1lk_fx-d16893e56072" class="topicref" data-id="concept_umc_1lk_fx" data-state="not-ready"><span role="button" tabindex="0" aria-labelledby="button-expand-action concept_umc_1lk_fx-d16893e56072-link" class="wh-expand-btn"></span><div class="title"><a href="../../../datacollector/UserGuide/Executors/Executors-title.html" id="concept_umc_1lk_fx-d16893e56072-link">Executors</a></div></div></li><li role="treeitem" aria-expanded="false"><div data-tocid="concept_xxd_f5r_kx-d16893e59696" class="topicref" data-id="concept_xxd_f5r_kx" data-state="not-ready"><span role="button" tabindex="0" aria-labelledby="button-expand-action concept_xxd_f5r_kx-d16893e59696-link" class="wh-expand-btn"></span><div class="title"><a href="../../../datacollector/UserGuide/Event_Handling/EventFramework-Title.html#concept_xxd_f5r_kx" id="concept_xxd_f5r_kx-d16893e59696-link">Dataflow Triggers</a></div></div></li><li role="treeitem" aria-expanded="false"><div data-tocid="concept_zq5_pb4_flb-d16893e60134" class="topicref" data-id="concept_zq5_pb4_flb" data-state="not-ready"><span role="button" tabindex="0" aria-labelledby="button-expand-action concept_zq5_pb4_flb-d16893e60134-link" class="wh-expand-btn"></span><div class="title"><a href="../../../datacollector/UserGuide/Solutions/Solutions-title.html" id="concept_zq5_pb4_flb-d16893e60134-link">Solutions</a></div></div></li><li role="treeitem" aria-expanded="true"><div data-tocid="concept_ugp_kwf_xw-d16893e61337" class="topicref" data-id="concept_ugp_kwf_xw" data-state="expanded"><span role="button" tabindex="0" aria-labelledby="button-collapse-action concept_ugp_kwf_xw-d16893e61337-link" class="wh-expand-btn"></span><div class="title"><a href="../../../datacollector/UserGuide/DPM/DPM_title.html" id="concept_ugp_kwf_xw-d16893e61337-link">StreamSets Control Hub</a></div></div><ul role="group" class="navbar-nav nav-list"><li role="treeitem" aria-expanded="false"><div data-tocid="concept_l45_qwf_xw-d16893e61359" class="topicref" data-id="concept_l45_qwf_xw" data-state="not-ready"><span role="button" tabindex="0" aria-labelledby="button-expand-action concept_l45_qwf_xw-d16893e61359-link" class="wh-expand-btn"></span><div class="title"><a href="../../../datacollector/UserGuide/DPM/DPM.html#concept_l45_qwf_xw" id="concept_l45_qwf_xw-d16893e61359-link">Meet <span class="ph">StreamSets Control Hub</span></a><div class="wh-tooltip"><p class="shortdesc"></p></div></div></div></li><li role="treeitem"><div data-tocid="concept_evb_3bs_bx-d16893e61559" class="topicref" data-id="concept_evb_3bs_bx" data-state="leaf"><span role="button" class="wh-expand-btn"></span><div class="title"><a href="../../../datacollector/UserGuide/DPM/WorkingWithDPM.html#concept_evb_3bs_bx" id="concept_evb_3bs_bx-d16893e61559-link">Working with <span class="ph">Control Hub</span></a><div class="wh-tooltip"><p class="shortdesc"></p></div></div></div></li><li role="treeitem"><div data-tocid="concept_lry_34g_xw-d16893e61585" class="topicref" data-id="concept_lry_34g_xw" data-state="leaf"><span role="button" class="wh-expand-btn"></span><div class="title"><a href="../../../datacollector/UserGuide/DPM/OrgUserAccount.html#concept_lry_34g_xw" id="concept_lry_34g_xw-d16893e61585-link">Request a <span class="ph">Control Hub</span> Organization and User Account</a><div class="wh-tooltip"><p class="shortdesc"></p></div></div></div></li><li role="treeitem" aria-expanded="true" class="active"><div data-tocid="concept_kc4_xyf_xw-d16893e61612" class="topicref" data-id="concept_kc4_xyf_xw" data-state="expanded"><span role="button" tabindex="0" aria-labelledby="button-collapse-action concept_kc4_xyf_xw-d16893e61612-link" class="wh-expand-btn"></span><div class="title"><a href="../../../datacollector/UserGuide/DPM/RegisterSDCwithDPM.html#concept_kc4_xyf_xw" id="concept_kc4_xyf_xw-d16893e61612-link">Register Data Collector with <span class="ph">Control Hub</span></a><div class="wh-tooltip"><p class="shortdesc"></p></div></div></div><ul role="group" class="navbar-nav nav-list"><li role="treeitem"><div data-tocid="concept_w11_n1q_rx-d16893e61638" class="topicref" data-id="concept_w11_n1q_rx" data-state="leaf"><span role="button" class="wh-expand-btn"></span><div class="title"><a href="../../../datacollector/UserGuide/DPM/RegisterSDCwithDPM.html#concept_w11_n1q_rx" id="concept_w11_n1q_rx-d16893e61638-link">Registration Prerequisites</a></div></div></li><li role="treeitem"><div data-tocid="task_a4y_v1g_xw-d16893e61660" class="topicref" data-id="task_a4y_v1g_xw" data-state="leaf"><span role="button" class="wh-expand-btn"></span><div class="title"><a href="../../../datacollector/UserGuide/DPM/RegisterSDCwithDPM.html#task_a4y_v1g_xw" id="task_a4y_v1g_xw-d16893e61660-link">Registering from Data Collector</a><div class="wh-tooltip"><p class="shortdesc">For a <span class="ph">Data Collector</span> tarball         installation, you can register the <span class="ph">Data Collector</span> with             <span class="ph">Control Hub</span>         using the <span class="ph">Data Collector</span> UI.</p></div></div></div></li><li role="treeitem"><div data-tocid="concept_js4_2z1_cx-d16893e61697" class="topicref" data-id="concept_js4_2z1_cx" data-state="leaf"><span role="button" class="wh-expand-btn"></span><div class="title"><a href="../../../datacollector/UserGuide/DPM/RegisterSDCwithDPM.html#concept_js4_2z1_cx" id="concept_js4_2z1_cx-d16893e61697-link">Registering from the Command Line Interface</a><div class="wh-tooltip"><p class="shortdesc">For a <span class="ph">Data Collector</span> tarball installation, you can register the <span class="ph">Data Collector</span> with             <span class="ph">Control Hub</span>         using the <span class="ph">Data Collector</span> command line interface. The <span class="ph">Data Collector</span> must be         running before you can use the command line interface.</p></div></div></div></li><li role="treeitem"><div data-tocid="task_oxx_y5m_xw-d16893e61737" class="topicref" data-id="task_oxx_y5m_xw" data-state="leaf"><span role="button" class="wh-expand-btn"></span><div class="title"><a href="../../../datacollector/UserGuide/DPM/RegisterSDCwithDPM.html#task_oxx_y5m_xw" id="task_oxx_y5m_xw-d16893e61737-link">Registering from Cloudera Manager</a><div class="wh-tooltip"><p class="shortdesc">If you installed <span class="ph">Data Collector</span>         through Cloudera Manager, you must use Cloudera Manager to register the <span class="ph">Data Collector</span> with             <span class="ph">Control Hub</span>.</p></div></div></div></li><li role="treeitem"><div data-tocid="concept_t2f_m1g_jx-d16893e61771" class="topicref" data-id="concept_t2f_m1g_jx" data-state="leaf"><span role="button" class="wh-expand-btn"></span><div class="title"><a href="../../../datacollector/UserGuide/DPM/RegisterSDCwithDPM.html#concept_t2f_m1g_jx" id="concept_t2f_m1g_jx-d16893e61771-link">Disconnected Mode</a><div class="wh-tooltip"><p class="shortdesc">After a <span class="ph">Data Collector</span> is         registered with <span class="ph">Control Hub</span>, the             <span class="ph">Data Collector</span>         communicates with <span class="ph">Control Hub</span> at         regular intervals - around every 30 seconds or less. If a <span class="ph">Data Collector</span> cannot         connect to <span class="ph">Control Hub</span>, due to         a network or system outage, then the <span class="ph">Data Collector</span> uses         the <span class="ph">Control Hub</span>         disconnected mode.</p></div></div></div></li><li role="treeitem"><div data-tocid="concept_dmr_df5_5y-d16893e61821" class="topicref" data-id="concept_dmr_df5_5y" data-state="leaf"><span role="button" class="wh-expand-btn"></span><div class="title"><a href="../../../datacollector/UserGuide/DPM/RegisterSDCwithDPM.html#concept_dmr_df5_5y" id="concept_dmr_df5_5y-d16893e61821-link">Using an HTTP or HTTPS Proxy Server</a><div class="wh-tooltip"><p class="shortdesc">You can configure each registered <span class="ph">Data Collector</span> to use         an authenticated HTTP or HTTPS proxy server for outbound requests made to <span class="ph">Control Hub</span>. Define         the proxy properties in the SDC_JAVA_OPTS environment variable. </p></div></div></div></li><li role="treeitem"><div data-tocid="concept_a42_stw_2z-d16893e61852" class="topicref" data-id="concept_a42_stw_2z" data-state="leaf"><span role="button" class="wh-expand-btn"></span><div class="title"><a href="../../../datacollector/UserGuide/DPM/RegisterSDCwithDPM.html#concept_a42_stw_2z" id="concept_a42_stw_2z-d16893e61852-link">Using a Publicly Accessible URL</a><div class="wh-tooltip"><p class="shortdesc">If you register a <span class="ph">Data Collector</span> that         is installed on a cloud-computing platform such as Amazon Elastic Compute Cloud (EC2),         configure the <span class="ph">Data Collector</span> to use         a publicly accessible URL.</p></div></div></div></li><li role="treeitem"><div data-tocid="concept_xzz_rnr_yy-d16893e61883" class="topicref" data-id="concept_xzz_rnr_yy" data-state="leaf"><span role="button" class="wh-expand-btn"></span><div class="title"><a href="../../../datacollector/UserGuide/DPM/RegisterSDCwithDPM.html#concept_xzz_rnr_yy" id="concept_xzz_rnr_yy-d16893e61883-link">Transfer Permissions to <span class="ph">Control Hub</span> Users</a></div></div></li></ul></li><li role="treeitem" aria-expanded="false"><div data-tocid="concept_h2q_mb5_xw-d16893e61908" class="topicref" data-id="concept_h2q_mb5_xw" data-state="not-ready"><span role="button" tabindex="0" aria-labelledby="button-expand-action concept_h2q_mb5_xw-d16893e61908-link" class="wh-expand-btn"></span><div class="title"><a href="../../../datacollector/UserGuide/DPM/AggregatedStatistics.html#concept_h2q_mb5_xw" id="concept_h2q_mb5_xw-d16893e61908-link">Pipeline Statistics</a><div class="wh-tooltip"><p class="shortdesc"></p></div></div></div></li><li role="treeitem" aria-expanded="false"><div data-tocid="concept_eq5_qjd_fx-d16893e62342" class="topicref" data-id="concept_eq5_qjd_fx" data-state="not-ready"><span role="button" tabindex="0" aria-labelledby="button-expand-action concept_eq5_qjd_fx-d16893e62342-link" class="wh-expand-btn"></span><div class="title"><a href="../../../datacollector/UserGuide/DPM/PipelineManagement.html#concept_eq5_qjd_fx" id="concept_eq5_qjd_fx-d16893e62342-link">Pipeline Management with <span class="ph">Control Hub</span></a><div class="wh-tooltip"><p class="shortdesc"></p></div></div></div></li><li role="treeitem"><div data-tocid="concept_hrn_zz3_fx-d16893e62532" class="topicref" data-id="concept_hrn_zz3_fx" data-state="leaf"><span role="button" class="wh-expand-btn"></span><div class="title"><a href="../../../datacollector/UserGuide/DPM/DPMConfiguration.html#concept_hrn_zz3_fx" id="concept_hrn_zz3_fx-d16893e62532-link"><span class="ph">Control Hub</span> Configuration File</a><div class="wh-tooltip"><p class="shortdesc"></p></div></div></div></li><li role="treeitem" aria-expanded="false"><div data-tocid="concept_ldb_sr5_cx-d16893e62558" class="topicref" data-id="concept_ldb_sr5_cx" data-state="not-ready"><span role="button" tabindex="0" aria-labelledby="button-expand-action concept_ldb_sr5_cx-d16893e62558-link" class="wh-expand-btn"></span><div class="title"><a href="../../../datacollector/UserGuide/DPM/UnregisterSDCwithDPM.html#concept_ldb_sr5_cx" id="concept_ldb_sr5_cx-d16893e62558-link">Unregister Data Collector from <span class="ph">Control Hub</span></a><div class="wh-tooltip"><p class="shortdesc"></p></div></div></div></li></ul></li><li role="treeitem" aria-expanded="false"><div data-tocid="concept_fyf_gkq_4bb-d16893e62693" class="topicref" data-id="concept_fyf_gkq_4bb" data-state="not-ready"><span role="button" tabindex="0" aria-labelledby="button-expand-action concept_fyf_gkq_4bb-d16893e62693-link" class="wh-expand-btn"></span><div class="title"><a href="../../../datacollector/UserGuide/Edge_Mode/EdgePipelines_title.html" id="concept_fyf_gkq_4bb-d16893e62693-link"><span class="ph">StreamSets Data Collector Edge</span></a></div></div></li><li role="treeitem" aria-expanded="false"><div data-tocid="concept_wwq_gxc_py-d16893e63980" class="topicref" data-id="concept_wwq_gxc_py" data-state="not-ready"><span role="button" tabindex="0" aria-labelledby="button-expand-action concept_wwq_gxc_py-d16893e63980-link" class="wh-expand-btn"></span><div class="title"><a href="../../../datacollector/UserGuide/Multithreaded_Pipelines/MultithreadedPipelines.html#concept_wwq_gxc_py" id="concept_wwq_gxc_py-d16893e63980-link">Multithreaded Pipelines</a></div></div></li><li role="treeitem" aria-expanded="false"><div data-tocid="concept_gzw_tdm_p2b-d16893e64187" class="topicref" data-id="concept_gzw_tdm_p2b" data-state="not-ready"><span role="button" tabindex="0" aria-labelledby="button-expand-action concept_gzw_tdm_p2b-d16893e64187-link" class="wh-expand-btn"></span><div class="title"><a href="../../../datacollector/UserGuide/Microservice/Microservice_Title.html#concept_gzw_tdm_p2b" id="concept_gzw_tdm_p2b-d16893e64187-link">Microservice Pipelines</a></div></div></li><li role="treeitem" aria-expanded="false"><div data-tocid="Orchestrators_Title-d16893e64348" class="topicref" data-id="Orchestrators_Title" data-state="not-ready"><span role="button" tabindex="0" aria-labelledby="button-expand-action Orchestrators_Title-d16893e64348-link" class="wh-expand-btn"></span><div class="title"><a href="../../../datacollector/UserGuide/Orchestration_Pipelines/OrchestrationPipelines_Title.html#Orchestrators_Title" id="Orchestrators_Title-d16893e64348-link">Orchestration Pipelines</a></div></div></li><li role="treeitem" aria-expanded="false"><div data-tocid="concept_wr1_ktz_bt-d16893e64489" class="topicref" data-id="concept_wr1_ktz_bt" data-state="not-ready"><span role="button" tabindex="0" aria-labelledby="button-expand-action concept_wr1_ktz_bt-d16893e64489-link" class="wh-expand-btn"></span><div class="title"><a href="../../../datacollector/UserGuide/RPC_Pipelines/SDC_RPCpipelines_title.html#concept_wr1_ktz_bt" id="concept_wr1_ktz_bt-d16893e64489-link">SDC RPC Pipelines</a></div></div></li><li role="treeitem" aria-expanded="false"><div data-tocid="concept_fpz_5r4_vs-d16893e64679" class="topicref" data-id="concept_fpz_5r4_vs" data-state="not-ready"><span role="button" tabindex="0" aria-labelledby="button-expand-action concept_fpz_5r4_vs-d16893e64679-link" class="wh-expand-btn"></span><div class="title"><a href="../../../datacollector/UserGuide/Cluster_Mode/ClusterPipelines_title.html" id="concept_fpz_5r4_vs-d16893e64679-link">Cluster Pipelines</a></div></div></li><li role="treeitem" aria-expanded="false"><div data-tocid="concept_jjk_23z_sq-d16893e65172" class="topicref" data-id="concept_jjk_23z_sq" data-state="not-ready"><span role="button" tabindex="0" aria-labelledby="button-expand-action concept_jjk_23z_sq-d16893e65172-link" class="wh-expand-btn"></span><div class="title"><a href="../../../datacollector/UserGuide/Data_Preview/DataPreview_Title.html#concept_jjk_23z_sq" id="concept_jjk_23z_sq-d16893e65172-link">Data Preview</a></div></div></li><li role="treeitem" aria-expanded="false"><div data-tocid="concept_pgk_brx_rr-d16893e65458" class="topicref" data-id="concept_pgk_brx_rr" data-state="not-ready"><span role="button" tabindex="0" aria-labelledby="button-expand-action concept_pgk_brx_rr-d16893e65458-link" class="wh-expand-btn"></span><div class="title"><a href="../../../datacollector/UserGuide/Alerts/RulesAlerts_title.html#concept_pgk_brx_rr" id="concept_pgk_brx_rr-d16893e65458-link">Rules and Alerts</a></div></div></li><li role="treeitem" aria-expanded="false"><div data-tocid="concept_asx_fdz_sq-d16893e65960" class="topicref" data-id="concept_asx_fdz_sq" data-state="not-ready"><span role="button" tabindex="0" aria-labelledby="button-expand-action concept_asx_fdz_sq-d16893e65960-link" class="wh-expand-btn"></span><div class="title"><a href="../../../datacollector/UserGuide/Pipeline_Monitoring/PipelineMonitoring_title.html#concept_asx_fdz_sq" id="concept_asx_fdz_sq-d16893e65960-link">Pipeline Monitoring</a></div></div></li><li role="treeitem" aria-expanded="false"><div data-tocid="concept_o3l_dtr_5q-d16893e66304" class="topicref" data-id="concept_o3l_dtr_5q" data-state="not-ready"><span role="button" tabindex="0" aria-labelledby="button-expand-action concept_o3l_dtr_5q-d16893e66304-link" class="wh-expand-btn"></span><div class="title"><a href="../../../datacollector/UserGuide/Pipeline_Maintenance/PipelineMaintenance_title.html#concept_o3l_dtr_5q" id="concept_o3l_dtr_5q-d16893e66304-link">Pipeline Maintenance</a></div></div></li><li role="treeitem" aria-expanded="false"><div data-tocid="concept_yms_ftm_sq-d16893e66768" class="topicref" data-id="concept_yms_ftm_sq" data-state="not-ready"><span role="button" tabindex="0" aria-labelledby="button-expand-action concept_yms_ftm_sq-d16893e66768-link" class="wh-expand-btn"></span><div class="title"><a href="../../../datacollector/UserGuide/Administration/Administration_title.html#concept_yms_ftm_sq" id="concept_yms_ftm_sq-d16893e66768-link">Administration</a></div></div></li><li role="treeitem" aria-expanded="false"><div data-tocid="concept_nls_w1r_ks-d16893e67508" class="topicref" data-id="concept_nls_w1r_ks" data-state="not-ready"><span role="button" tabindex="0" aria-labelledby="button-expand-action concept_nls_w1r_ks-d16893e67508-link" class="wh-expand-btn"></span><div class="title"><a href="../../../datacollector/UserGuide/Tutorial/Tutorial-title.html" id="concept_nls_w1r_ks-d16893e67508-link">Tutorial</a></div></div></li><li role="treeitem" aria-expanded="false"><div data-tocid="concept_sh3_frm_tq-d16893e68001" class="topicref" data-id="concept_sh3_frm_tq" data-state="not-ready"><span role="button" tabindex="0" aria-labelledby="button-expand-action concept_sh3_frm_tq-d16893e68001-link" class="wh-expand-btn"></span><div class="title"><a href="../../../datacollector/UserGuide/Troubleshooting/Troubleshooting_title.html#concept_sh3_frm_tq" id="concept_sh3_frm_tq-d16893e68001-link">Troubleshooting</a></div></div></li><li role="treeitem" aria-expanded="false"><div data-tocid="concept_xbx_rs1_tq-d16893e68798" class="topicref" data-id="concept_xbx_rs1_tq" data-state="not-ready"><span role="button" tabindex="0" aria-labelledby="button-expand-action concept_xbx_rs1_tq-d16893e68798-link" class="wh-expand-btn"></span><div class="title"><a href="../../../datacollector/UserGuide/Glossary/Glossary_title.html#concept_xbx_rs1_tq" id="concept_xbx_rs1_tq-d16893e68798-link">Glossary</a></div></div></li><li role="treeitem" aria-expanded="false"><div data-tocid="concept_jn1_nzb_kv-d16893e68843" class="topicref" data-id="concept_jn1_nzb_kv" data-state="not-ready"><span role="button" tabindex="0" aria-labelledby="button-expand-action concept_jn1_nzb_kv-d16893e68843-link" class="wh-expand-btn"></span><div class="title"><a href="../../../datacollector/UserGuide/Apx-DataFormats/DataFormat_Title.html#concept_jn1_nzb_kv" id="concept_jn1_nzb_kv-d16893e68843-link">Data Formats by Stage</a><div class="wh-tooltip"><p class="shortdesc"></p></div></div></div></li><li role="treeitem" aria-expanded="false"><div data-tocid="concept_pvm_yt3_wq-d16893e68958" class="topicref" data-id="concept_pvm_yt3_wq" data-state="not-ready"><span role="button" tabindex="0" aria-labelledby="button-expand-action concept_pvm_yt3_wq-d16893e68958-link" class="wh-expand-btn"></span><div class="title"><a href="../../../datacollector/UserGuide/Expression_Language/ExpressionLanguage_title.html" id="concept_pvm_yt3_wq-d16893e68958-link">Expression Language</a></div></div></li><li role="treeitem" aria-expanded="false"><div data-tocid="concept_vcj_1ws_js-d16893e69669" class="topicref" data-id="concept_vcj_1ws_js" data-state="not-ready"><span role="button" tabindex="0" aria-labelledby="button-expand-action concept_vcj_1ws_js-d16893e69669-link" class="wh-expand-btn"></span><div class="title"><a href="../../../datacollector/UserGuide/Apx-RegEx/RegEx-Title.html#concept_vcj_1ws_js" id="concept_vcj_1ws_js-d16893e69669-link">Regular Expressions</a></div></div></li><li role="treeitem" aria-expanded="false"><div data-tocid="concept_chv_vmj_wr-d16893e69787" class="topicref" data-id="concept_chv_vmj_wr" data-state="not-ready"><span role="button" tabindex="0" aria-labelledby="button-expand-action concept_chv_vmj_wr-d16893e69787-link" class="wh-expand-btn"></span><div class="title"><a href="../../../datacollector/UserGuide/Apx-GrokPatterns/GrokPatterns_title.html#concept_chv_vmj_wr" id="concept_chv_vmj_wr-d16893e69787-link">Grok Patterns</a></div></div></li></ul></div>
                        

</div>
</nav>
                    


                    
                    <div id="wh_topic_body" class="col-lg-7 col-md-9 col-sm-12">
<button id="wh_close_publication_toc_button" class="close-toc-button d-none" aria-label="Toggle publishing table of content" aria-controls="wh_publication_toc" aria-expanded="true"><span class="close-toc-icon-container"><span class="close-toc-icon"></span></span></button><button id="wh_close_topic_toc_button" class="close-toc-button d-none" aria-label="Toggle topic table of content" aria-controls="wh_topic_toc" aria-expanded="true"><span class="close-toc-icon-container"><span class="close-toc-icon"></span></span></button>

                        
<div class=" wh_topic_content body "><main role="main"><article class="" role="article" aria-labelledby="ariaid-title1"><article class="nested0" aria-labelledby="ariaid-title1" id="concept_kc4_xyf_xw">
    <h1 class="- topic/title title topictitle1" id="ariaid-title1">Register Data Collector with <span class="- topic/ph ph">Control Hub</span></h1>
    
    <div class="- topic/body concept/conbody body conbody"><p class="- topic/shortdesc shortdesc"></p>
        <p class="- topic/p p">You must register a <span class="- topic/ph ph">Data Collector</span> to
            work with <span class="- topic/ph ph">StreamSets Control Hub</span>. When you register a <span class="- topic/ph ph">Data Collector</span>,
                <span class="- topic/ph ph">Data Collector</span>
            generates an authentication token that it uses to issue authenticated requests to <span class="- topic/ph ph">Control Hub</span>.</p>
        <div class="- topic/p p">The method you use to register a <span class="- topic/ph ph">Data Collector</span>
            depends on the <span class="- topic/ph ph">Data Collector</span>
            installation type:<dl class="- topic/dl dl">
                
                    <dt class="- topic/dt dt dlterm">Tarball installation</dt>
                    <dd class="- topic/dd dd">You can register the <span class="- topic/ph ph">Data Collector</span> from the <span class="- topic/ph ph">Data Collector</span> UI, from the command line interface, or from <span class="- topic/ph ph">Control Hub</span>.</dd>
                
                
                    <dt class="- topic/dt dt dlterm">RPM installation</dt>
                    <dd class="- topic/dd dd">You must register the <span class="- topic/ph ph">Data Collector</span> from <span class="- topic/ph ph">Control Hub</span>.</dd>
                
                
                    <dt class="- topic/dt dt dlterm">Cloudera Manager installation</dt>
                    <dd class="- topic/dd dd">You must register the <span class="- topic/ph ph">Data Collector</span> from Cloudera Manager.</dd>
                
            </dl></div>
        <p class="- topic/p p">A registered <span class="- topic/ph ph">Data Collector</span>
            communicates with <span class="- topic/ph ph">Control Hub</span> at
            regular intervals. If a <span class="- topic/ph ph">Data Collector</span>
            cannot connect to <span class="- topic/ph ph">Control Hub</span>,
            due to a network or system outage, then the <span class="- topic/ph ph">Data Collector</span>
            uses the <span class="- topic/ph ph">Control Hub</span>
            disconnected mode.</p>
        <p class="- topic/p p">You can optionally configure each registered <span class="- topic/ph ph">Data Collector</span> to
            use an authenticated HTTP proxy server to access <span class="- topic/ph ph">Control Hub</span>.</p>
        <p class="- topic/p p">Before you register a <span class="- topic/ph ph">Data Collector</span>,
            perform the necessary prerequisites. The prerequisites include creating new <span class="- topic/ph ph">Control Hub</span>
            users and groups. After registration, be sure to transfer permissions to the new <span class="- topic/ph ph">Control Hub</span>
            users and groups.</p>
    </div>
<article class="- topic/topic concept/concept topic concept nested1" aria-labelledby="ariaid-title2" id="concept_w11_n1q_rx">
 <h2 class="- topic/title title topictitle2" id="ariaid-title2">Registration Prerequisites</h2>
 <div class="- topic/body concept/conbody body conbody">
  <p class="- topic/p p">Before you register <span class="- topic/ph ph">Data Collector</span>s,
            complete the following prerequisites:</p>
        <dl class="- topic/dl dl">
            
                <dt class="- topic/dt dt dlterm">Verify that the statistics stage library is installed.</dt>
                <dd class="- topic/dd dd">
                    <p class="- topic/p p"><span class="- topic/ph ph">Control Hub</span> requires that the
                statistics stage library be installed on each registered <span class="- topic/ph ph">Data Collector</span>. <span class="- topic/ph ph">Control Hub</span> requires the library to
                run system pipelines on the <span class="- topic/ph ph">Data Collector</span>. By default, all <span class="- topic/ph ph">Data Collector</span>
                installations include the statistics stage library.</p>
                </dd>
                <dd class="- topic/dd dd ddexpand">To verify that a <span class="- topic/ph ph">Data Collector</span> has the statistics stage library installed, click the Package Manager icon
                        (<img class="- topic/image image" id="concept_w11_n1q_rx__image_hgv_t1q_rx" src="../Graphics/icon_PackageManager.png" height="13" width="16"/>) to display the list of installed stage libraries.
                    If the statistics library was uninstalled, <a class="- topic/xref xref" href="../Installation/AddtionalStageLibs.html#concept_fb2_qmn_bz">install
                        the library</a> before registering the <span class="- topic/ph ph">Data Collector</span>.</dd>
            
            
                <dt class="- topic/dt dt dlterm">Create a <span class="- topic/ph ph">Control Hub</span> user account and group for each <span class="- topic/ph ph">Data Collector</span> user and group.</dt>
                <dd class="- topic/dd dd">
                    <p class="- topic/p p">If your organization currently uses <span class="- topic/ph ph">Data Collector</span>, you must create a <span class="- topic/ph ph">Control Hub</span> user account and group
                for each <span class="- topic/ph ph">Data Collector</span> user account and
                group, assigning the corresponding <span class="- topic/ph ph">Data Collector</span> roles to each. After a
                    <span class="- topic/ph ph">Data Collector</span> is registered with
                    <span class="- topic/ph ph">Control Hub</span>, the <span class="- topic/ph ph">Data Collector</span> uses <span class="- topic/ph ph">Control Hub</span> user authentication. Only
                    <span class="- topic/ph ph">Control Hub</span> user accounts can log
                in to registered <span class="- topic/ph ph">Data Collector</span>s.</p>
                </dd>
                <dd class="- topic/dd dd ddexpand">
                    <p class="- topic/p p">If your organization is not using <span class="- topic/ph ph">Data Collector</span>, you can skip this
                prerequisite. You can create new <span class="- topic/ph ph">Control Hub</span> user accounts and groups
                at any time.</p>
                </dd>
                <dd class="- topic/dd dd ddexpand">
                    <p class="- topic/p p">Registered <span class="- topic/ph ph">Data Collector</span>s belong to the
                organization of the user who completes the registration. All user accounts that
                belong to the same organization and that have the appropriate roles can log in to
                the registered <span class="- topic/ph ph">Data Collector</span>s.</p>
                </dd>
                <dd class="- topic/dd dd ddexpand">For instructions on creating corresponding <span class="- topic/ph ph">Control Hub</span> user accounts, see the first tutorial in the <span class="- topic/ph ph">Control Hub</span> online help.<div class="- topic/note note tip note_tip"><span class="note__title">Tip:</span> If <span class="- topic/ph ph">Data Collector</span> uses file-based authentication and if you register the <span class="- topic/ph ph">Data Collector</span> from the <span class="- topic/ph ph">Data Collector</span> UI, you can skip this step and create <span class="- topic/ph ph">Control Hub</span> user accounts during the registration process, as described in <a class="- topic/xref xref" href="RegisterSDCwithDPM.html#task_a4y_v1g_xw" title="For a Data Collector tarball installation, you can register the Data Collector with Control Hub using the Data Collector UI.">Registering from Data Collector</a>.</div></dd>
            
        </dl>
 </div>
</article><article class="- topic/topic task/task topic task nested1" aria-labelledby="ariaid-title3" id="task_a4y_v1g_xw">
    <h2 class="- topic/title title topictitle2" id="ariaid-title3">Registering from Data Collector</h2>
    
    <div class="- topic/body task/taskbody body taskbody"><p class="- topic/shortdesc shortdesc">For a <span class="- topic/ph ph">Data Collector</span> tarball
        installation, you can register the <span class="- topic/ph ph">Data Collector</span> with
            <span class="- topic/ph ph">Control Hub</span>
        using the <span class="- topic/ph ph">Data Collector</span> UI.</p>
        <section class="- topic/section task/context section context">
            <div class="- topic/note note note note_note"><span class="note__title">Note:</span> For a <span class="- topic/ph ph">Data Collector</span>
                RPM installation, you must use <a class="- topic/xref xref" href="https://streamsets.com/documentation/controlhub/latest/help/controlhub/UserGuide/DataCollectors/ManualAdmin.html#task_uwf_lwv_hw" target="_blank" rel="external noopener">Control Hub to register</a> the <span class="- topic/ph ph">Data Collector</span>. For a <span class="- topic/ph ph">Data Collector</span>
                installation with Cloudera Manager, you must <a class="- topic/xref xref" href="RegisterSDCwithDPM.html#task_oxx_y5m_xw" title="If you installed Data Collector through Cloudera Manager, you must use Cloudera Manager to register the Data Collector with Control Hub.">use Cloudera Manager to
                    register</a> the <span class="- topic/ph ph">Data Collector</span>. </div>
            <p class="- topic/p p">
                
            </p>
        </section>
        <section class="- topic/ol task/steps ol steps"><ol class="- topic/ol task/steps ol steps"><li class="- topic/li task/step li step">
                <span class="- topic/ph task/cmd ph cmd">Log in to <span class="- topic/ph ph">Data Collector</span> using your <span class="- topic/ph ph">Data Collector</span> user account.</span>
            </li><li class="- topic/li task/step li step">
                <span class="- topic/ph task/cmd ph cmd">Click <span class="+ topic/ph ui-d/menucascade ph menucascade"><span class="+ topic/ph ui-d/uicontrol ph uicontrol">Administration</span><abbr title="and then"> &gt; </abbr><span class="+ topic/ph ui-d/uicontrol ph uicontrol"> Enable Control Hub</span></span>.</span>
            </li><li class="- topic/li task/step li step">
                <span class="- topic/ph task/cmd ph cmd">Enter the following information in the <span class="+ topic/keyword ui-d/wintitle keyword wintitle">Enable Control Hub</span>
                    window:</span>
                <div class="- topic/itemgroup task/info itemgroup info">
                    <div class="table-container"><table class="- topic/table table frame-all" id="task_a4y_v1g_xw__table_sld_z4l_nw" data-ofbid="task_a4y_v1g_xw__table_sld_z4l_nw" data-cols="2"><caption></caption><colgroup><col style="width:33.33333333333333%"/><col style="width:66.66666666666666%"/></colgroup><thead class="- topic/thead thead">
                                <tr class="- topic/row">
                                    <th class="- topic/entry entry colsep-1 rowsep-1" id="task_a4y_v1g_xw__table_sld_z4l_nw__entry__1">Property</th>
                                    <th class="- topic/entry entry colsep-0 rowsep-1" id="task_a4y_v1g_xw__table_sld_z4l_nw__entry__2">Description</th>
                                </tr>
                            </thead><tbody class="- topic/tbody tbody">
                                <tr class="- topic/row">
                                    <td class="- topic/entry entry colsep-1 rowsep-1" headers="task_a4y_v1g_xw__table_sld_z4l_nw__entry__1"><span class="- topic/ph ph">Control Hub</span> Base URL</td>
                                    <td class="- topic/entry entry colsep-0 rowsep-1" headers="task_a4y_v1g_xw__table_sld_z4l_nw__entry__2">Required. Set to the appropriate URL:<ul class="- topic/ul ul" id="task_a4y_v1g_xw__ul_btk_yrz_yfb" data-ofbid="task_a4y_v1g_xw__ul_btk_yrz_yfb">
                                    <li class="- topic/li li">For <span class="- topic/ph ph">Control Hub</span>
                                        cloud, enter
                                            <kbd class="+ topic/ph sw-d/userinput ph userinput">https://cloud.streamsets.com</kbd>.</li>
                                    <li class="- topic/li li">For <span class="- topic/ph ph">Control Hub</span>
                                        on-premises, enter the URL provided by your system
                                        administrator. For example,
                                            <kbd class="+ topic/ph sw-d/userinput ph userinput">https://&lt;hostname&gt;:18631</kbd>.</li>
                                    
                                </ul></td>
                                </tr>
                                <tr class="- topic/row">
                                    <td class="- topic/entry entry colsep-1 rowsep-1" headers="task_a4y_v1g_xw__table_sld_z4l_nw__entry__1"><span class="- topic/ph ph">Control Hub</span> User ID</td>
                                    <td class="- topic/entry entry colsep-0 rowsep-1" headers="task_a4y_v1g_xw__table_sld_z4l_nw__entry__2">Enter your <span class="- topic/ph ph">Control Hub</span> user ID using the following format:<div class="- topic/p p">
                  <pre class="+ topic/pre pr-d/codeblock pre codeblock"><code>&lt;ID&gt;@&lt;organization ID&gt;</code></pre>
            </div></td>
                                </tr>
                                <tr class="- topic/row">
                                    <td class="- topic/entry entry colsep-1 rowsep-1" headers="task_a4y_v1g_xw__table_sld_z4l_nw__entry__1"><span class="- topic/ph ph">Control Hub</span> User Password</td>
                                    <td class="- topic/entry entry colsep-0 rowsep-1" headers="task_a4y_v1g_xw__table_sld_z4l_nw__entry__2">Enter the password for your <span class="- topic/ph ph">Control Hub</span> user account.</td>
                                </tr>
                                <tr class="- topic/row">
                                    <td class="- topic/entry entry colsep-1 rowsep-0" headers="task_a4y_v1g_xw__table_sld_z4l_nw__entry__1">Labels for this <span class="- topic/ph ph">Data Collector</span></td>
                                    <td class="- topic/entry entry colsep-0 rowsep-0" headers="task_a4y_v1g_xw__table_sld_z4l_nw__entry__2">Assign a label to this <span class="- topic/ph ph">Data Collector</span>. Labels that you assign here are defined in the <span class="- topic/ph ph">Control Hub</span> configuration file,
                                            <code class="+ topic/ph pr-d/codeph ph codeph">$SDC_CONF/dpm.properties</code>. To remove
                                        these labels after you register the <span class="- topic/ph ph">Data Collector</span>, you must modify the configuration file.<p class="- topic/p p">Use labels to
                                            group <span class="- topic/ph ph">Data Collector</span>s registered with <span class="- topic/ph ph">Control Hub</span>. If you know how you want to group your <span class="- topic/ph ph">Data Collector</span>s, you can assign labels now. Or you can assign labels
                                            in <span class="- topic/ph ph">Control Hub</span> after you register the <span class="- topic/ph ph">Data Collector</span>.</p><p class="- topic/p p">Default is "all", which you can use to run a
                                            job on all registered <span class="- topic/ph ph">Data Collector</span>s.</p></td>
                                </tr>
                            </tbody></table></div>
                </div>
            </li><li class="- topic/li task/step li step">
                <span class="- topic/ph task/cmd ph cmd">Click <span class="+ topic/ph ui-d/uicontrol ph uicontrol">Enable</span>.</span>
            </li><li class="- topic/li task/step li step">
                <span class="- topic/ph task/cmd ph cmd">Optionally, you can choose to create a <span class="- topic/ph ph">Control Hub</span> user account and group for each <span class="- topic/ph ph">Data Collector</span> user account and group.</span>
                <div class="- topic/itemgroup task/info itemgroup info">The <span class="+ topic/ph ui-d/uicontrol ph uicontrol">Create Control Hub Groups and Users</span> window maps all
                    existing <span class="- topic/ph ph">Data Collector</span> user accounts and groups to <span class="- topic/ph ph">Control Hub</span> user accounts and groups. You can remove users or groups and can edit the
                    IDs, names, and email addresses as needed.<p class="- topic/p p">When you have finished reviewing
                        the users and groups to create, click <span class="+ topic/ph ui-d/uicontrol ph uicontrol">Create</span>. Each
                        new user is assigned a default set of <span class="- topic/ph ph">Control Hub</span> roles. Groups are not assigned any roles. After you log in to <span class="- topic/ph ph">Control Hub</span>, change the default role assignments as needed to secure the integrity of
                        your organization and data. </p></div>
            </li><li class="- topic/li task/step li step">
                <span class="- topic/ph task/cmd ph cmd">Restart <span class="- topic/ph ph">Data Collector</span>.</span>
            </li><li class="- topic/li task/step li step">
                <span class="- topic/ph task/cmd ph cmd">Open the <span class="- topic/ph ph">Data Collector</span> configuration file, <code class="+ topic/ph pr-d/codeph ph codeph">$SDC_CONF/sdc.properties</code>, and verify
                    that the <span class="+ topic/ph ui-d/uicontrol ph uicontrol">http.authentication.login.module</span> property is set
                    to <span class="+ topic/ph ui-d/uicontrol ph uicontrol">file</span>. </span>
                <div class="- topic/itemgroup task/info itemgroup info"><span class="- topic/ph ph">Control Hub</span> requires that each registered <span class="- topic/ph ph">Data Collector</span> be configured for file-based authentication. After a <span class="- topic/ph ph">Data Collector</span> is registered with <span class="- topic/ph ph">Control Hub</span>, the <span class="- topic/ph ph">Data Collector</span> uses the authentication method enabled for <span class="- topic/ph ph">Control Hub</span>.</div>
                <div class="- topic/itemgroup task/info itemgroup info">When you log in to the registered <span class="- topic/ph ph">Data Collector</span> using a <span class="- topic/ph ph">Control Hub</span> user account, the following <span class="- topic/ph ph">Control Hub</span> Enabled icon displays:<p class="- topic/p p"><img class="- topic/image image" id="task_a4y_v1g_xw__image_hrt_tdk_3w" src="../Graphics/SDC_DPMEnabled.png" height="60" width="700"/></p></div>
                <div class="- topic/itemgroup task/info itemgroup info"><span class="- topic/ph ph">To enable <span class="- topic/ph ph">Control Hub</span> users to
                        work with pipelines, transfer permissions to the <span class="- topic/ph ph">Control Hub</span> users and
                        groups. For more information, see <span class="- topic/ph ph"><a class="- topic/xref xref" href="RegisterSDCwithDPM.html#concept_xzz_rnr_yy">Transfer Permissions to Control Hub Users</a></span>.</span></div>
            </li></ol></section>
    </div>
</article><article class="- topic/topic concept/concept topic concept nested1" aria-labelledby="ariaid-title4" id="concept_js4_2z1_cx">
 <h2 class="- topic/title title topictitle2" id="ariaid-title4">Registering from the Command Line Interface</h2>
 
 <div class="- topic/body concept/conbody body conbody"><p class="- topic/shortdesc shortdesc">For a <span class="- topic/ph ph">Data Collector</span> tarball installation, you can register the <span class="- topic/ph ph">Data Collector</span> with
            <span class="- topic/ph ph">Control Hub</span>
        using the <span class="- topic/ph ph">Data Collector</span> command line interface. The <span class="- topic/ph ph">Data Collector</span> must be
        running before you can use the command line interface.</p>
        <p class="- topic/p p">For a <span class="- topic/ph ph">Data Collector</span> RPM installation, you must use <a class="- topic/xref xref" href="https://streamsets.com/documentation/controlhub/latest/help/controlhub/UserGuide/DataCollectors/ManualAdmin.html#task_uwf_lwv_hw" target="_blank" rel="external noopener">Control Hub to register</a> the <span class="- topic/ph ph">Data Collector</span>.
            For a <span class="- topic/ph ph">Data Collector</span> installation with Cloudera Manager, you must <a class="- topic/xref xref" href="RegisterSDCwithDPM.html#task_oxx_y5m_xw" title="If you installed Data Collector through Cloudera Manager, you must use Cloudera Manager to register the Data Collector with Control Hub.">use Cloudera Manager to
                register</a> the <span class="- topic/ph ph">Data Collector</span>. </p>
        <div class="- topic/note note note note_note"><span class="note__title">Note:</span> To use an automation tool such as Ansible, Chef, or Puppet to automate the registering
            of <span class="- topic/ph ph">Data Collector</span>s, configure the tool to use theÂ <code class="+ topic/ph pr-d/codeph ph codeph">streamsets sch register</code>Â command. The
            command must be run on the local machine where <span class="- topic/ph ph">Data Collector</span> is
            installed. The <span class="- topic/ph ph">Data Collector</span>
            does not need to be running. See the command line help for the list of available
            options. If you choose to skip updating the <code class="+ topic/ph pr-d/codeph ph codeph">dpm.properties</code>
            configuration file, you must configure the automation tool to update the file.</div>
        <p class="- topic/p p">Start <span class="- topic/ph ph">Data Collector</span>,
            and then use the system enableDPM command to register the <span class="- topic/ph ph">Data Collector</span>. </p>
        <div class="- topic/p p">Use the command from the <code class="+ topic/ph pr-d/codeph ph codeph">$SDC_DIST</code> directory as
            follows:<pre class="+ topic/pre pr-d/codeblock pre codeblock"><code>bin/streamsets cli \
(-U &lt;sdcURL&gt; | --url &lt;sdcURL&gt;) \
[(-D &lt;dpmURL&gt; | --dpmURL &lt;dpmURL&gt;)] \
[(-a &lt;sdcAuthType&gt; | --auth-type &lt;sdcAuthType&gt;)] \
[(-u &lt;sdcUser&gt; | --user &lt;sdcUser&gt;)] \
[(-p &lt;sdcPassword&gt; | --password &lt;sdcPassword&gt;)] \
system enableDPM \
(--dpmUrl &lt;dpmBaseURL&gt;) \
(--dpmUser &lt;dpmUserID&gt;) \
(--dpmPassword &lt;dpmUserPassword&gt;) \
[(--labels &lt;labels&gt;)]</code></pre></div>
        <p class="- topic/p p">When using the system enableDPM command, the following basic options are required:</p>
        <div class="table-container"><table class="- topic/table table frame-all" id="concept_js4_2z1_cx__table_lkb_qkl_nx" data-ofbid="concept_js4_2z1_cx__table_lkb_qkl_nx" data-cols="2"><caption></caption><colgroup><col style="width:33.33333333333333%"/><col style="width:66.66666666666666%"/></colgroup><thead class="- topic/thead thead">
                    <tr class="- topic/row">
                        <th class="- topic/entry entry colsep-1 rowsep-1" id="concept_js4_2z1_cx__table_lkb_qkl_nx__entry__1">Basic Option</th>
                        <th class="- topic/entry entry colsep-0 rowsep-1" id="concept_js4_2z1_cx__table_lkb_qkl_nx__entry__2">Description</th>
                    </tr>
                </thead><tbody class="- topic/tbody tbody">
                    <tr class="- topic/row">
                        <td class="- topic/entry entry colsep-1 rowsep-1" headers="concept_js4_2z1_cx__table_lkb_qkl_nx__entry__1">-U &lt;sdcURL&gt;<p class="- topic/p p">or</p>--url &lt;sdcURL&gt;</td>
                        <td class="- topic/entry entry colsep-0 rowsep-1" headers="concept_js4_2z1_cx__table_lkb_qkl_nx__entry__2">Required. URL of the <span class="- topic/ph ph">Data Collector</span>.<p class="- topic/p p">The default URL is
                                    <samp class="+ topic/ph sw-d/systemoutput ph systemoutput sysout">http://localhost:18630</samp>.</p></td>
                    </tr>
                    <tr class="- topic/row">
                        <td class="- topic/entry entry colsep-1 rowsep-0" headers="concept_js4_2z1_cx__table_lkb_qkl_nx__entry__1">-D &lt;dpmURL&gt;<p class="- topic/p p">or</p><p class="- topic/p p">--dpmURL &lt;dpmURL&gt;</p></td>
                        <td class="- topic/entry entry colsep-0 rowsep-0" headers="concept_js4_2z1_cx__table_lkb_qkl_nx__entry__2">Required. Enter the appropriate URL:<ul class="- topic/ul ul" id="concept_js4_2z1_cx__ul_jp4_zjn_yfb" data-ofbid="concept_js4_2z1_cx__ul_jp4_zjn_yfb">
                                    <li class="- topic/li li">For <span class="- topic/ph ph">Control Hub</span>
                                        cloud, enter
                                            <kbd class="+ topic/ph sw-d/userinput ph userinput">https://cloud.streamsets.com</kbd>.</li>
                                    <li class="- topic/li li">For <span class="- topic/ph ph">Control Hub</span>
                                        on-premises, enter the URL provided by your system
                                        administrator. For example,
                                            <kbd class="+ topic/ph sw-d/userinput ph userinput">https://&lt;hostname&gt;:18631</kbd>.</li>
                                    
                                </ul></td>
                    </tr>
                </tbody></table></div>
        <p class="- topic/p p">The following table describes the enableDPM options:</p>
  <div class="- topic/p p"><div class="table-container"><table class="- topic/table table frame-all" id="concept_js4_2z1_cx__table_njq_3bb_cx" data-ofbid="concept_js4_2z1_cx__table_njq_3bb_cx" data-cols="2"><caption></caption><colgroup><col style="width:33.33333333333333%"/><col style="width:66.66666666666666%"/></colgroup><thead class="- topic/thead thead">
                        <tr class="- topic/row">
                            <th class="- topic/entry entry colsep-1 rowsep-1" id="concept_js4_2z1_cx__table_njq_3bb_cx__entry__1">Enable DPM Option</th>
                            <th class="- topic/entry entry colsep-0 rowsep-1" id="concept_js4_2z1_cx__table_njq_3bb_cx__entry__2">Description</th>
                        </tr>
                    </thead><tbody class="- topic/tbody tbody">
                        <tr class="- topic/row">
                            <td class="- topic/entry entry colsep-1 rowsep-1" headers="concept_js4_2z1_cx__table_njq_3bb_cx__entry__1">--dpmUrl &lt;dpmBaseURL&gt;</td>
                            <td class="- topic/entry entry colsep-0 rowsep-1" headers="concept_js4_2z1_cx__table_njq_3bb_cx__entry__2">Required. Enter the appropriate URL:<ul class="- topic/ul ul" id="concept_js4_2z1_cx__ul_pm1_bkn_yfb" data-ofbid="concept_js4_2z1_cx__ul_pm1_bkn_yfb">
                                    <li class="- topic/li li">For <span class="- topic/ph ph">Control Hub</span>
                                        cloud, enter
                                            <kbd class="+ topic/ph sw-d/userinput ph userinput">https://cloud.streamsets.com</kbd>.</li>
                                    <li class="- topic/li li">For <span class="- topic/ph ph">Control Hub</span>
                                        on-premises, enter the URL provided by your system
                                        administrator. For example,
                                            <kbd class="+ topic/ph sw-d/userinput ph userinput">https://&lt;hostname&gt;:18631</kbd>.</li>
                                    
                                </ul></td>
                        </tr>
                        <tr class="- topic/row">
                            <td class="- topic/entry entry colsep-1 rowsep-1" headers="concept_js4_2z1_cx__table_njq_3bb_cx__entry__1">--dpmUser &lt;dpmUserID&gt;</td>
                            <td class="- topic/entry entry colsep-0 rowsep-1" headers="concept_js4_2z1_cx__table_njq_3bb_cx__entry__2">Required. Enter your <span class="- topic/ph ph">Control Hub</span> user ID using the following format:<div class="- topic/p p">
                  <pre class="+ topic/pre pr-d/codeblock pre codeblock"><code>&lt;ID&gt;@&lt;organization ID&gt;</code></pre>
            </div></td>
                        </tr>
                        <tr class="- topic/row">
                            <td class="- topic/entry entry colsep-1 rowsep-1" headers="concept_js4_2z1_cx__table_njq_3bb_cx__entry__1">--dpmPassword &lt;dpmUserPassword&gt;</td>
                            <td class="- topic/entry entry colsep-0 rowsep-1" headers="concept_js4_2z1_cx__table_njq_3bb_cx__entry__2">Required. Enter the password for your <span class="- topic/ph ph">Control Hub</span> user account.</td>
                        </tr>
                        <tr class="- topic/row">
                            <td class="- topic/entry entry colsep-1 rowsep-0" headers="concept_js4_2z1_cx__table_njq_3bb_cx__entry__1">--labels &lt;labels&gt;</td>
                            <td class="- topic/entry entry colsep-0 rowsep-0" headers="concept_js4_2z1_cx__table_njq_3bb_cx__entry__2">Optional. Assign a label to this <span class="- topic/ph ph">Data Collector</span>. You can enter multiple labels separated by commas. Labels that
                                you assign here are defined in the <span class="- topic/ph ph">Control Hub</span> configuration file, <code class="+ topic/ph pr-d/codeph ph codeph">$SDC_CONF/dpm.properties</code>. To
                                remove these labels after you register the <span class="- topic/ph ph">Data Collector</span>, you must modify the configuration file.<p class="- topic/p p">Use labels to group
                                        <span class="- topic/ph ph">Data Collector</span>s registered with <span class="- topic/ph ph">Control Hub</span>. If you know how you want to group your <span class="- topic/ph ph">Data Collector</span>s, you can assign labels now. Or you can assign labels in <span class="- topic/ph ph">Control Hub</span> after you register the <span class="- topic/ph ph">Data Collector</span>.</p><p class="- topic/p p">Default is "all", which you can use to run a job on
                                    all registered <span class="- topic/ph ph">Data Collector</span>s.</p></td>
                        </tr>
                    </tbody></table></div>For example, the following command registers a <span class="- topic/ph ph">Data Collector</span>
            with <span class="- topic/ph ph">Control Hub</span> and assigns three labels to the <span class="- topic/ph ph">Data Collector</span>:<pre class="+ topic/pre pr-d/codeblock pre codeblock"><code>bin/streamsets cli -U http://localhost:18630 -D https://cloud.streamsets.com system enableDPM --dpmUrl https://cloud.streamsets.com --dpmUser alison@MyOrg --dpmPassword MyPassword --labels Finance,Accounting,Development</code></pre></div>
        <div class="- topic/note note important note_important"><span class="note__title">Important:</span> Open the <span class="- topic/ph ph">Data Collector</span>
            configuration file, <code class="+ topic/ph pr-d/codeph ph codeph">$SDC_CONF/sdc.properties</code>, and verify that the
                <span class="+ topic/ph ui-d/uicontrol ph uicontrol">http.authentication.login.module</span> property is set to
                <span class="+ topic/ph ui-d/uicontrol ph uicontrol">file</span>. <span class="- topic/ph ph">Control Hub</span>
            requires that each registered <span class="- topic/ph ph">Data Collector</span> be
            configured for file-based authentication. After a <span class="- topic/ph ph">Data Collector</span> is
            registered with <span class="- topic/ph ph">Control Hub</span>,
            the <span class="- topic/ph ph">Data Collector</span>
            uses the authentication method enabled for <span class="- topic/ph ph">Control Hub</span>.</div>
        <p class="- topic/p p">Restart the <span class="- topic/ph ph">Data Collector</span> to
            apply the changes. </p>
        <p class="- topic/p p">When you log in to the registered <span class="- topic/ph ph">Data Collector</span>
            using a <span class="- topic/ph ph">Control Hub</span>
            user account, the following <span class="- topic/ph ph">Control Hub</span>
            Enabled icon displays:</p>
     <p class="- topic/p p"><img class="- topic/image image" id="concept_js4_2z1_cx__image_hrt_tdk_3w" src="../Graphics/SDC_DPMEnabled.png" height="60" width="700"/></p>
        <p class="- topic/p p"><span class="- topic/ph ph">To enable <span class="- topic/ph ph">Control Hub</span> users to
                        work with pipelines, transfer permissions to the <span class="- topic/ph ph">Control Hub</span> users and
                        groups. For more information, see <span class="- topic/ph ph"><a class="- topic/xref xref" href="RegisterSDCwithDPM.html#concept_xzz_rnr_yy">Transfer Permissions to Control Hub Users</a></span>.</span></p>
 </div>
</article><article class="- topic/topic task/task topic task nested1" aria-labelledby="ariaid-title5" id="task_oxx_y5m_xw">
    <h2 class="- topic/title title topictitle2" id="ariaid-title5">Registering from Cloudera Manager</h2>
    
    <div class="- topic/body task/taskbody body taskbody"><p class="- topic/shortdesc shortdesc">If you installed <span class="- topic/ph ph">Data Collector</span>
        through Cloudera Manager, you must use Cloudera Manager to register the <span class="- topic/ph ph">Data Collector</span> with
            <span class="- topic/ph ph">Control Hub</span>.</p>
        <section class="- topic/section task/context section context">
            
        </section>
        <section class="- topic/ol task/steps ol steps"><ol class="- topic/ol task/steps ol steps"><li class="- topic/li task/step li step">
                <span class="- topic/ph task/cmd ph cmd">In Cloudera Manager, select the <span class="+ topic/ph ui-d/uicontrol ph uicontrol">StreamSets</span> service, then
                    click <span class="+ topic/ph ui-d/uicontrol ph uicontrol">Configuration</span>.</span>
            </li><li class="- topic/li task/step li step">
                <span class="- topic/ph task/cmd ph cmd">Enter "<span class="- topic/ph ph">Control Hub</span>" in the search field to display the <span class="- topic/ph ph">Control Hub</span> configuration properties.</span>
            </li><li class="- topic/li task/step li step">
                <span class="- topic/ph task/cmd ph cmd">Configure the following properties:</span>
                <div class="- topic/itemgroup task/info itemgroup info">
                    <div class="table-container"><table class="- topic/table table frame-all" id="task_oxx_y5m_xw__table_sld_z4l_nw" data-ofbid="task_oxx_y5m_xw__table_sld_z4l_nw" data-cols="2"><caption></caption><colgroup><col style="width:33.33333333333333%"/><col style="width:66.66666666666666%"/></colgroup><thead class="- topic/thead thead">
                                <tr class="- topic/row">
                                    <th class="- topic/entry entry colsep-1 rowsep-1" id="task_oxx_y5m_xw__table_sld_z4l_nw__entry__1">Property</th>
                                    <th class="- topic/entry entry colsep-0 rowsep-1" id="task_oxx_y5m_xw__table_sld_z4l_nw__entry__2">Description</th>
                                </tr>
                            </thead><tbody class="- topic/tbody tbody">
                                <tr class="- topic/row">
                                    <td class="- topic/entry entry colsep-1 rowsep-1" headers="task_oxx_y5m_xw__table_sld_z4l_nw__entry__1">Enable <span class="- topic/ph ph">Control Hub</span></td>
                                    <td class="- topic/entry entry colsep-0 rowsep-1" headers="task_oxx_y5m_xw__table_sld_z4l_nw__entry__2">Select to enable <span class="- topic/ph ph">Control Hub</span>.</td>
                                </tr>
                                <tr class="- topic/row">
                                    <td class="- topic/entry entry colsep-1 rowsep-1" headers="task_oxx_y5m_xw__table_sld_z4l_nw__entry__1"><span class="- topic/ph ph">Control Hub</span> URL</td>
                                    <td class="- topic/entry entry colsep-0 rowsep-1" headers="task_oxx_y5m_xw__table_sld_z4l_nw__entry__2">Required. Enter the appropriate URL:<ul class="- topic/ul ul" id="task_oxx_y5m_xw__ul_jcl_csz_yfb" data-ofbid="task_oxx_y5m_xw__ul_jcl_csz_yfb">
                                    <li class="- topic/li li">For <span class="- topic/ph ph">Control Hub</span>
                                        cloud, enter
                                            <kbd class="+ topic/ph sw-d/userinput ph userinput">https://cloud.streamsets.com</kbd>.</li>
                                    <li class="- topic/li li">For <span class="- topic/ph ph">Control Hub</span>
                                        on-premises, enter the URL provided by your system
                                        administrator. For example,
                                            <kbd class="+ topic/ph sw-d/userinput ph userinput">https://&lt;hostname&gt;:18631</kbd>.</li>
                                    
                                </ul></td>
                                </tr>
                                <tr class="- topic/row">
                                    <td class="- topic/entry entry colsep-1 rowsep-1" headers="task_oxx_y5m_xw__table_sld_z4l_nw__entry__1"><span class="- topic/ph ph">Control Hub</span> User ID</td>
                                    <td class="- topic/entry entry colsep-0 rowsep-1" headers="task_oxx_y5m_xw__table_sld_z4l_nw__entry__2">Enter your <span class="- topic/ph ph">Control Hub</span> user ID using the following format:<div class="- topic/p p">
                  <pre class="+ topic/pre pr-d/codeblock pre codeblock"><code>&lt;ID&gt;@&lt;organization ID&gt;</code></pre>
            </div></td>
                                </tr>
                                <tr class="- topic/row">
                                    <td class="- topic/entry entry colsep-1 rowsep-1" headers="task_oxx_y5m_xw__table_sld_z4l_nw__entry__1"><span class="- topic/ph ph">Control Hub</span> Password</td>
                                    <td class="- topic/entry entry colsep-0 rowsep-1" headers="task_oxx_y5m_xw__table_sld_z4l_nw__entry__2">Enter the password for your <span class="- topic/ph ph">Control Hub</span> user account.</td>
                                </tr>
                                <tr class="- topic/row">
                                    <td class="- topic/entry entry colsep-1 rowsep-0" headers="task_oxx_y5m_xw__table_sld_z4l_nw__entry__1"><span class="- topic/ph ph">Control Hub</span> Labels</td>
                                    <td class="- topic/entry entry colsep-0 rowsep-0" headers="task_oxx_y5m_xw__table_sld_z4l_nw__entry__2">Assign a label to this <span class="- topic/ph ph">Data Collector</span>. Labels that you assign here are defined in the <span class="- topic/ph ph">Control Hub</span> configuration file,
                                            <code class="+ topic/ph pr-d/codeph ph codeph">$SDC_CONF/dpm.properties</code>. To remove
                                        these labels after you register the <span class="- topic/ph ph">Data Collector</span>, you must modify the labels through Cloudera
                                            Manager.<p class="- topic/p p">Use labels to group <span class="- topic/ph ph">Data Collector</span>s registered with <span class="- topic/ph ph">Control Hub</span>. If you know how you want to group your <span class="- topic/ph ph">Data Collector</span>s, you can assign labels now. Or you can assign labels
                                            in <span class="- topic/ph ph">Control Hub</span> after you register the <span class="- topic/ph ph">Data Collector</span>.</p>Default is "all", which you can use to run a job
                                        on all registered <span class="- topic/ph ph">Data Collector</span>s.</td>
                                </tr>
                            </tbody></table></div>
                </div>
            </li><li class="- topic/li task/step li step">
                <span class="- topic/ph task/cmd ph cmd">Set the <span class="+ topic/ph ui-d/uicontrol ph uicontrol">HTTP Authentication Login Module</span> property to
                        <span class="+ topic/ph ui-d/uicontrol ph uicontrol">file</span>.</span>
                <div class="- topic/itemgroup task/info itemgroup info"><span class="- topic/ph ph">Control Hub</span> requires that each registered <span class="- topic/ph ph">Data Collector</span> be configured for file-based authentication. After a <span class="- topic/ph ph">Data Collector</span> is registered with <span class="- topic/ph ph">Control Hub</span>, the <span class="- topic/ph ph">Data Collector</span> uses the authentication method enabled for <span class="- topic/ph ph">Control Hub</span>.</div>
            </li><li class="- topic/li task/step li step">
                <span class="- topic/ph task/cmd ph cmd">Click <span class="+ topic/ph ui-d/uicontrol ph uicontrol">Save Changes</span>.</span>
            </li><li class="- topic/li task/step li step">
                <span class="- topic/ph task/cmd ph cmd">Click <span class="+ topic/ph ui-d/menucascade ph menucascade"><span class="+ topic/ph ui-d/uicontrol ph uicontrol">Actions</span><abbr title="and then"> &gt; </abbr><span class="+ topic/ph ui-d/uicontrol ph uicontrol"> Restart</span></span> to restart the <span class="- topic/ph ph">Data Collector</span>.</span>
                <div class="- topic/itemgroup task/info itemgroup info">When you log in to the registered <span class="- topic/ph ph">Data Collector</span> using a <span class="- topic/ph ph">Control Hub</span> user account, the following <span class="- topic/ph ph">Control Hub</span> Enabled icon displays:<p class="- topic/p p"><img class="- topic/image image" id="task_oxx_y5m_xw__image_hrt_tdk_3w" src="../Graphics/SDC_DPMEnabled.png" height="60" width="700"/></p><p class="- topic/p p"><span class="- topic/ph ph">To enable <span class="- topic/ph ph">Control Hub</span> users to
                        work with pipelines, transfer permissions to the <span class="- topic/ph ph">Control Hub</span> users and
                        groups. For more information, see <span class="- topic/ph ph"><a class="- topic/xref xref" href="RegisterSDCwithDPM.html#concept_xzz_rnr_yy">Transfer Permissions to Control Hub Users</a></span>.</span></p></div>
            </li></ol></section>
    </div>
</article><article class="- topic/topic concept/concept topic concept nested1" aria-labelledby="ariaid-title6" id="concept_t2f_m1g_jx">
 <h2 class="- topic/title title topictitle2" id="ariaid-title6">Disconnected Mode</h2>
 
 <div class="- topic/body concept/conbody body conbody"><p class="- topic/shortdesc shortdesc">After a <span class="- topic/ph ph">Data Collector</span> is
        registered with <span class="- topic/ph ph">Control Hub</span>, the
            <span class="- topic/ph ph">Data Collector</span>
        communicates with <span class="- topic/ph ph">Control Hub</span> at
        regular intervals - around every 30 seconds or less. If a <span class="- topic/ph ph">Data Collector</span> cannot
        connect to <span class="- topic/ph ph">Control Hub</span>, due to
        a network or system outage, then the <span class="- topic/ph ph">Data Collector</span> uses
        the <span class="- topic/ph ph">Control Hub</span>
        disconnected mode.</p>
        <p class="- topic/p p">In disconnected mode, you can still log into and use
                <span class="- topic/ph ph">Data Collector</span>. However, you cannot publish pipelines to <span class="- topic/ph ph">Control Hub</span>,
            view pipeline commit history, or download published pipelines from <span class="- topic/ph ph">Control Hub</span>.
            When the <span class="- topic/ph ph">Data Collector</span>
            can connect to <span class="- topic/ph ph">Control Hub</span>
            again, it switches back to the <span class="- topic/ph ph">Control Hub</span>
            enabled mode - and then you can continue to manage how pipelines work with <span class="- topic/ph ph">Control Hub</span>.</p>
        <p class="- topic/p p">If a <span class="- topic/ph ph">Data Collector</span> switches to disconnected mode while you are logged in, <span class="- topic/ph ph">Data Collector</span>
            requires that you log in again with your <span class="- topic/ph ph">Control Hub</span>
            user account. After you log in, the following Disconnected Mode icon displays:</p>
        <p class="- topic/p p"><img class="- topic/image image" id="concept_t2f_m1g_jx__image_ztz_bkg_jx" src="../Graphics/SDC_DPMDisconnected.png" height="65" width="759"/></p>
    </div>
</article><article class="- topic/topic concept/concept topic concept nested1" aria-labelledby="ariaid-title7" id="concept_dmr_df5_5y">
    <h2 class="- topic/title title topictitle2" id="ariaid-title7">Using an HTTP or HTTPS Proxy Server</h2>
    
    <div class="- topic/body concept/conbody body conbody"><p class="- topic/shortdesc shortdesc">You can configure each registered <span class="- topic/ph ph">Data Collector</span> to use
        an authenticated HTTP or HTTPS proxy server for outbound requests made to <span class="- topic/ph ph">Control Hub</span>. Define
        the proxy properties in the SDC_JAVA_OPTS environment variable. </p>
        
        <p class="- topic/p p"><a class="- topic/xref xref" href="../Configuration/DCEnvironmentConfig.html#concept_zhl_rb3_qcb">Modify environment variables</a> using the method required by your installation
                  type.</p>
        <p class="- topic/p p">Add the following Java options to the SDC_JAVA_OPTS
            environment variable:</p>
        <ul class="- topic/ul ul" id="concept_dmr_df5_5y__ul_ovt_fr5_5y" data-ofbid="concept_dmr_df5_5y__ul_ovt_fr5_5y">
            <li class="- topic/li li"><code class="+ topic/ph pr-d/codeph ph codeph">https.proxyUser</code></li>
            <li class="- topic/li li"><code class="+ topic/ph pr-d/codeph ph codeph">https.proxyPassword</code></li>
            <li class="- topic/li li"><code class="+ topic/ph pr-d/codeph ph codeph">https.proxyHost</code></li>
            <li class="- topic/li li"><code class="+ topic/ph pr-d/codeph ph codeph">https.proxyPort</code></li>
        </ul>
        <p class="- topic/p p">If the proxy server uses HTTP instead of HTTPS, use <code class="+ topic/ph pr-d/codeph ph codeph">http.&lt;property
                name&gt;</code> for each property.</p>
        <p class="- topic/p p">For example, to configure a <span class="- topic/ph ph">Data Collector</span> to
            use an HTTPS proxy server on host 138.0.0.1 and port 3138, define SDC_JAVA_OPTS as
            follows: </p>
        <pre class="+ topic/pre pr-d/codeblock pre codeblock"><code>export SDC_JAVA_OPTS="${SDC_JAVA_OPTS} -Xmx1024m -Xms1024m <span class="+ topic/ph ui-d/uicontrol ph uicontrol">-Dhttps.proxyUser=MyName -Dhttps.proxyPassword=MyPsswrd -Dhttps.proxyHost=138.0.0.1 -Dhttps.proxyPort=3138</span> -server" </code></pre>
        <div class="- topic/note note note note_note"><span class="note__title">Note:</span> Oracle JDK disabled HTTP proxy authentication for HTTPS URLs in JDK 8 update 111. If
                <span class="- topic/ph ph">Data Collector</span>
            runs on a machine with Java 8u111 or later, consider using an HTTPS proxy server. Or as
            a workaround, consider adding the following Java property to the SDC_JAVA_OPTS
            environment variable, setting the property to an empty string:<div class="- topic/p p">
                <pre class="+ topic/pre pr-d/codeblock pre codeblock"><code>-Djdk.http.auth.tunneling.disabledSchemes=''</code></pre>
            </div><p class="- topic/p p">However, use this workaround with caution since it exposes credentials by sending
                them through an unencrypted proxy.</p></div>
    </div>
</article><article class="- topic/topic concept/concept topic concept nested1" aria-labelledby="ariaid-title8" id="concept_a42_stw_2z">
 <h2 class="- topic/title title topictitle2" id="ariaid-title8">Using a Publicly Accessible URL</h2>
 
 <div class="- topic/body concept/conbody body conbody"><p class="- topic/shortdesc shortdesc">If you register a <span class="- topic/ph ph">Data Collector</span> that
        is installed on a cloud-computing platform such as Amazon Elastic Compute Cloud (EC2),
        configure the <span class="- topic/ph ph">Data Collector</span> to use
        a publicly accessible URL.</p>
        
        <p class="- topic/p p">When you register a <span class="- topic/ph ph">Data Collector</span>
            with <span class="- topic/ph ph">Control Hub</span>, the <span class="- topic/ph ph">Data Collector</span>
            sends its URL to <span class="- topic/ph ph">Control Hub</span> in
            the format <code class="+ topic/ph pr-d/codeph ph codeph">http://&lt;hostname&gt;:&lt;http.port&gt;</code>, where
                <code class="+ topic/ph pr-d/codeph ph codeph">&lt;hostname&gt;</code> is the value defined in the
                <code class="+ topic/ph pr-d/codeph ph codeph">http.bindHost</code> property in the <span class="- topic/ph ph">Data Collector</span>
            configuration file, <code class="+ topic/ph pr-d/codeph ph codeph">$SDC_CONF/sdc.properties</code>. If the host name is not
            defined in <code class="+ topic/ph pr-d/codeph ph codeph">http.bindHost</code>, <span class="- topic/ph ph">Data Collector</span>
            runs the following command to determine the host name: <code class="+ topic/ph pr-d/codeph ph codeph">hostname -f</code></p>
        <p class="- topic/p p">For most cloud-computing platforms, the <code class="+ topic/ph pr-d/codeph ph codeph">hostname -f</code> command returns the
            private IP address of the machine on the cloud platform. <span class="- topic/ph ph">Control Hub</span>
            includes the private IP address in the<span class="- topic/ph ph">Data Collector</span>
            URL displayed in <span class="- topic/ph ph">Control Hub</span>.
            However, when you click the <span class="- topic/ph ph">Data Collector</span>
            URL, you cannot access the <span class="- topic/ph ph">Data Collector</span>
            because you must use a public IP address to access a cloud machine. </p>
        <p class="- topic/p p">To access a <span class="- topic/ph ph">Data Collector</span>
            installed on a cloud-computing platform from <span class="- topic/ph ph">Control Hub</span>,
            uncomment the <code class="+ topic/ph pr-d/codeph ph codeph">sdc.base.http.url</code> property in the <span class="- topic/ph ph">Data Collector</span>
            configuration file, <code class="+ topic/ph pr-d/codeph ph codeph">$SDC_CONF/sdc.properties</code>, and then configure it to
            use the publicly accessible URL to that <span class="- topic/ph ph">Data Collector</span>. </p>
        <p class="- topic/p p">After modifying the configuration file, restart <span class="- topic/ph ph">Data Collector</span>
            for the changes to take effect.</p>
 </div>
</article><article class="- topic/topic concept/concept topic concept nested1" aria-labelledby="ariaid-title9" id="concept_xzz_rnr_yy">
 <h2 class="- topic/title title topictitle2" id="ariaid-title9">Transfer Permissions to <span class="- topic/ph ph">Control Hub</span>
        Users</h2>
 <div class="- topic/body concept/conbody body conbody">
        <p class="- topic/p p">After you register <span class="- topic/ph ph">Data Collector</span>
            with <span class="- topic/ph ph">Control Hub</span>, transfer permissions from the obsolete <span class="- topic/ph ph">Data Collector</span>
            users and groups to the new <span class="- topic/ph ph">Control Hub</span>
            users and groups.</p>
        <p class="- topic/p p">When pipeline access controls are enabled in <span class="- topic/ph ph">Data Collector</span>,
            pipeline permissions determine the access that each user has to a pipeline. Any user
            without the Admin role requires read permission to view a pipeline. So by default, only
                <span class="- topic/ph ph">Control Hub</span>
            users with the Organization Administrator or Engine Administrator roles can access
            pipelines immediately after registering <span class="- topic/ph ph">Data Collector</span>.</p>
        <p class="- topic/p p">To enable other users to access pipelines, transfer pipeline permissions to <span class="- topic/ph ph">Control Hub</span>
            users and groups. When you transfer permissions, all permissions associated with a user
            or group transfers to the specified user or group. If you need to customize pipeline
            permissions, you can edit each pipeline individually.</p>
        <p class="- topic/p p">For information about transferring pipeline permissions, see <a class="- topic/xref xref" href="../Configuration/RolesandPermissions.html#concept_p11_msc_1z">Transfer Pipeline Permissions</a>. For
            information about configuring permissions for individual pipelines, see <a class="- topic/xref xref" href="../Pipeline_Maintenance/PipelineMaintenance_title.html#concept_jrg_1vy_wy">Sharing Pipelines</a>.</p>
    </div>
</article></article></article></main></div>

                        
                        
                        


                    </div>
                    
                </div>
            </div>


        </div> <nav class="navbar navbar-default wh_footer" data-whc_version="25.0">
  <div class=" footer-container  mx-auto">
    <!-- script for Data Collector, all flavors, but only used when accessed directly, not from portal --><script>
  (function(i,s,o,g,r,a,m){i['GoogleAnalyticsObject']=r;i[r]=i[r]||function(){
  (i[r].q=i[r].q||[]).push(arguments)},i[r].l=1*new Date();a=s.createElement(o),
  m=s.getElementsByTagName(o)[0];a.async=1;a.src=g;m.parentNode.insertBefore(a,m)
  })(window,document,'script','https://www.google-analytics.com/analytics.js','ga');

  ga('create', 'UA-60917135-3', 'auto');
  ga('send', 'pageview');
</script>
  </div>
</nav>

        
        <div id="go2top">
            <span class="oxy-icon oxy-icon-up"></span>
        </div>
        
        <!-- The modal container for images -->
        <div id="modal_img_large" class="modal">
            <span class="close oxy-icon oxy-icon-remove"></span>
            <!-- Modal Content (The Image) -->
            <div id="modal_img_container"></div>
            <!-- Modal Caption (Image Text) -->
            <div id="caption"></div>
        </div>
        
        
        Â© 2023 StreamSets, Inc.

    </body>
</html>